nit: hotdata>=0.2.0 is listed as a direct dependency, but nothing in this package imports hotdata directly — only hotdata_runtime and langchain_core. It's already pulled in transitively via hotdata-runtime, so this line can be dropped to keep the direct dependency set minimal. (not blocking)

nit: this text.split("\n\n", 2) branch assumes the preamble between # Changelog and the first version heading is a single paragraph, but the Keep a Changelog template (which CHANGELOG.md here uses) has two paragraphs: the "All notable changes…" line and the "The format is based on…" line. When [Unreleased] actually contains notes, parts[1] only captures the first paragraph and the new ## [X.Y.Z] block gets spliced between the two preamble paragraphs, pushing "The format is based on…" below the new release.

The current PR isn't affected because [Unreleased] is empty (so the else branch on line 142 runs), but the next release with notes will produce a malformed changelog. Easiest fix is to anchor on ## [Unreleased] directly, e.g.

text = text.replace("## [Unreleased]", insert.rstrip() + "\n\n## [Unreleased]", 1)

after building insert as f"## [{ver}] - {date}\n{body}" (without the leading ## [Unreleased]). That keeps both else and this branch on one consistent path. (not blocking)

nit: pyproject.toml declares requires-python = ">=3.10", but CI only exercises Python 3.12. The code uses 3.10+ generic syntax (list[str] | None) under from __future__ import annotations, so it should work on 3.10/3.11, but nothing here verifies those versions stay green. Consider a strategy.matrix.python-version: ['3.10', '3.11', '3.12'] so a regression at the lower bounds is caught before users hit it. (not blocking)